Bernie ][ The Rescue 2.6

Total Integration

1. Introduction

> 1.1 Installation

2. Copying Files To The Apple IIGS

> 2.1 Copying Files To The Apple IIgs Finder

> 2.2 Copying Files To A GS/OS Application

3. Copying Files To The Macintosh

> 3.1 The Bernie.Transfer Folders

> 3.2 Preparing For File Transfers

> 3.3 How To Copy Files

4. Error Reporting

5. Shared Clipboards

6. Cross-Platform Aliases

1. Introduction

Bernie ][ The Rescue is a full-featured emulator offering the most complete set of features found on an original Apple IIgs. In your everyday work with Bernie, however, you are typically not just limiting yourself to the Apple II environment but do a reasonable sharing of tasks between your virtual Apple II and your Mac. You might be using your Mac for surfing the web and checking your e-mail while composing documents in AppleWorks Classic. Emulators are no longer just measured up by how they emulate a platform but also how well they integrate into your existing system.

Bernie Total Integration is the first serious attempt to offer true Apple IIgs/Mac integration and data mobility. It is a work in progress and will gradually evolve into - total integration. So, what can it do for you?

Bernie Total Integration allows you to exchange

- clipboards
- files

Please keep in mind that the functionality discussed herein is only available from within GS/OS applications, and only if they make use of the toolbox. (There is no way for Bernie to support applications that come with a proprietary clipboard implementation.)

To exchange clipboards, Bernie adds a hotkey that enhances Copy and Paste commands from the Edit menu. Choosing Copy in a Apple IIgs application places a copy of the selected text into the Macintosh clipboard. Choosing Paste in a Apple IIgs application pastes the Macintosh clipboard.

Copying files is a snap. You can...

- drag & drop files into the Apple IIgs Finder
- copy files from the Apple IIgs Finder to a download folder on the Mac

Bernie can copy entire file trees, preserves file types and automatically adapts file names to the requirements of the target OS.

##

1.1 Installation

Bernie Total Integration (BTI) comes in two parts. One part is already built into the Bernie application while another comes as a GS/OS system extension: the Bernie Enabler. Hence it is not possible to just add the Bernie Enabler to an older copy of Bernie.

BTI requires system 6.0 or 6.0.1. Since it is a GS/OS-specific system file, it is not functional under any other operating system such as ProDOS 8 or DOS 3.3.

To install BTI follow these steps:

- start Bernie with a GS/OS system disk version 6.0 or 6.0.1
- mount the disk image "Bernie Total Integration" that came with the Bernie distribution. It is located in the folder "Total Integration".
- the Apple IIgs Finder will show the disk. There is a single file on it, the "Bernie.Enabler".
- copy this file into your GS/OS startup disk's System.Setup folder. (The folder is located inside the "System" folder on your GS/OS startup disk.)
- restart GS/OS to activate the new features

A successful installation looks like this:

The Bernie.Enabler has been copied into the System.Setup folder inside the System folder

Congratulations, Bernie Total Integration is now installed. If you have multiple GS/OS startup disks you would most likely want to copy the Bernie.Enabler file onto them as well.

2. Copying Files To The Apple II GS

This chapter explains how you can copy files between MacOS and GS/OS.

2.1 Copying Files To The Apple IIgs Finder

The most straightforward approach is to copy files with the IIgs Finder being the active application. Follow these steps:

- open a directory window in Bernie.

- select the Mac files and drag them into an open Apple IIgs Finder window:

When you release the mouse button, the files will be copied to the directory window onto which the files were dropped. If you dropped the file(s) into the desktop area or some other place other than a directory window, the file(s) will be copied to a special folder. (See section 2.2 below for more information.)

We recommend you that you keep the status bar visible: Bernie will display the current file and tell you when the copy session is done with.

During a copy session Bernie does not respond to any other events.

File Types and Names

File types are preserved. Types encoded to PC/File Exchange standards will be applied. Although files may have a generic ("dog-eared") icon on the Mac, their original file type will restored when they are copied back.

Unfortunately, the ProDOS file system has very restrictive naming conventions. Therefore, Bernie converts file names by providing a close match.

Size Limitations

There is no limit on how many files or folders can be copied except that you might run out of available memory. The file expansion algorithm goes a number of extra miles for saving memory, so this is rather unlikely.

Duplicate Files

Bernie does not replace duplicate files by default. If you rather prefer the opposite, that is, want to give Bernie permission to delete a duplicate file in the destination directory, there's a check box for enabling this option. Please see chapter 3.2 for details.

2.2 Copying Files To A GS/OS Application

The previous section explained how to copy files with the IIgs Finder running. It is, however, also possible to copy files in any other GS/OS desktop application.

When you drop files into the Apple IIgs Finder and there's no Finder directory window open or no Finder around, Bernie puts the files into the folder

> <startup disk>:Bernie.Transfer:

Bernie will create the transfer folder automatically if it doesn't already exist.

3. Copying Files To The Macintosh

3.1 The Bernie.Transfer Folders

Copying files from the Apple IIgs to the Mac works slightly differently than the other way around. Since it's not possible to drag&drop files outside the video window, Bernie Total Integration introduces "transfer folders". Whenever you drop files or folders into a transfer folder, you indicate Bernie that you'd like to copy the data to a Mac disk.

To prepare for future IIgs->Mac copy sessions, create a folder titled Bernie.Transfer on any disk you like and in whatever directory. You can even have multiple transfer directories around, such as one on the desktop and another one in your working directory. As long as you call them Bernie.Transfer, Bernie will figure it out. These directories will stay empty anyway (exception: see chapter 2.2, "Copying Files To A GS/OS Application").

3.2 Preparing For File Transfers

Before you can copy files, you need to tell Bernie where to put the files on your Macintosh hard disk. The preferences window has a dedicated "Total Integration" section where you can pick a download folder:

Pick a download location by pushing "Select Download Folder"

You need to choose a download location only once. All subsequent copy operations will use that folder.

There's also a check box "Overwrite duplicates". By default, Bernie refuses to replace files in the target directory and will generate an error in the error log. By checking "Overwrite duplicates", you give Bernie permission to permanently delete files at the target destination so the copy operation can be completed. Please use this option wisely as it may result in loss of data!

3.3 How To Copy Files

Now that you created a transfer directory or chose a download folder, let's push some bytes around. Grab a folder and drag&drop it onto the transfer directory:

Here we're dragging the System folder into the transfer directory

Bernie will start copying the files. This process may take some time. Again we recommend that you keep the status bar visible so you know what's going on. The status bar will display the currently being copied. The message "Done" appears when all files have been processed.

4. Error Reporting

Bernie Total Integration comes with very explicit error reporting when things go wrong during a copy session.

When an error occurs, Bernie opens a dedicated window where it keeps track of the ten most recent errors. It lists each incident with the file's pathname, a human-readable description of the problem plus during what kind of copy session the problem occurred:

The window has a capacity of 10 items. The oldest item will be deleted when a new error occurs.

Please remember that Bernie does not really like replacing files - for your data's security. If you want to explicitely overwrite duplicates:

- when copying files from the Mac to the GS, hold down the option key when dropping the files into Bernie
- when copying files from the GS to the Mac, check the box "replace duplicates" when Bernie is asking for the download location

The error messages will be preserved when closing and reopening the window. To open it, choose "Copy Errors" from the Window menu.

5. Shared Clipboards

Bernie Total Integration enhances the standard Copy and Paste commands so that you can directly access the Macintosh clipboard:

- you can paste the Mac clipboard into a IIgs desktop application
- you can copy text from a IIgs desktop application to the Mac clipboard

To activate the enhanced Copy&Paste functions, hold down the option key while choosing the Copy or Paste menu items.

Bernie supports plain ASCII text only. You can't copy&paste styled text or pictures.

Example: Pasting the Mac clipboard into a GS/OS application

Assume the Mac clipboard contains the following:

Now hold down the option key and choose the Paste command from the File menu:

Choose Paste while holding down the option key

...which yields the following result:

Example: Copying the IIgs clipboard to the Mac clipboard

Analogously to the previous example, highlight some text and copy it to the clipboard. Remember to hold down the option key:

Choose Copy while holding down the option key

...yields:

6. Cross-Platform Aliases

Bernie Total Integration 1.2 introduces cross-platform aliases. A cross-platform alias is a link to a GS/OS application or document. The link is stored on your Macintosh hard disk. Upon double-clicking an alias file, the following happens:

- if not already running, Bernie will be launched
- when Bernie has finished booting into GS/OS, the application will be started
- if you clicked a document link, the document will be opened

Cross-platform aliases only work within GS/OS. It is assumed that you have configured Bernie so that it automatically mounts a GS/OS startup disk with Bernie Total Integration installed. If Bernie does not mount GS/OS disks automatically, lacks the Total Integration extension or the Finder will not become the active application for whatever reason, the alias will be queued until all of the former conditions are met.

To create an alias, start the Apple IIgs Finder and select a single document or application:

Make an alias by selecting an application or document and choosing "Create Alias..."

Then open the "Extras" menu and choose "Create Alias...". Bernie will open a Save As dialog for saving the alias to a Mac disk.

Note: if the Extras menu does not appear on your system, the GS/OS system disk you're using has not been enhanced with Bernie Total Integration. Please see chapter 1.1 for installation.

Registering | Getting Started | Audio/Video | Storage
Communications | Printing | Preferences | Total Integration

Bernie Home | F.E.Systems Home